s3uzip14.zip

This archive contains an EPOC binary for version 1.41 of Unzip
for Psion Series 3, 3a, HC, MC400 and Workabout machines, plus
some documentation.

This port is based on the Samuel H. Smith / Info-ZIP team source
code, the home FTP site for which is ftp.uu.net:/pub/archiving/

Version 1.41 incorporates a workaround for a bug in Pkzip-made
archives, whereby the Huffman distance tree may be incomplete in
some circumstances. The program will note this by displaying
'(incomplete d-tree)' after the file name, when extracting or
testing an archive. Archives created with the generic version of
Zip do not exhibit this problem.

Version 1.4 adds support for external applications that invoke
UNZIP.IMG, specifying the destination directory to which files
are to be extracted. See the enclosed file APPNOTES.TXT for more
information.

Version 1.3 added support for unzipping from remote files across
the serial link. This did not work in prior versions due to the
failure of the CLIB stat() function across filesystems. See below
for an example of remote unzipping.

Version 1.3 *removed* support for the old (prior to Pkzip 2.0)
compression methods. This is to save space (and hence memory) and
reflects the fact that such archives are increasingly rare.

UnZip requires considerable free memory to run, so its not
suitable for unzipping other than small files to the internal
drive.

To use interactively on Series 3/3a machines, you need version
1.1 of RUN.APP (included in this archive) as the front-end for
the UNZIP.IMG file.

See the enclosed file RUN.DOC for brief notes on installing and
using the RUN utility. Quick quide: create a \RUN directory and
copy UNZIP.IMG there; copy RUN.APP into an \APP directory, and
install it on the system screen by keying Psion-I.

Here are some examples of the use of the 'Initial path' parameter
with UnZip:

  Command line:  -l a:\transfer\myzip
  Initial path:

  Command line:  -l myzip
  Initial path:  a:\transfer

Where only a listing of the archive contents is requested, the
two forms above are identical. Where an archive extraction is
specified however, the 'Initial path' parameter specifies the
directory to which the files archived should be extracted. For
example:

  Command line:  a:\transfer\myzip
  Initial path:  b:\

will cause the files in MYZIP.ZIP in the specified directory to
be extracted to the root directory of drive B. Note that the full
path name of the archive must be specified on the command line.

As of version 1.3, remote files can be unzipped using Unzip and
Mclink or Slink. If Slink is used, it must be version 1.2 or
later.

  Command line: rem::f:\download\newstuff
  Initial path: a:\

will extract the remote zipfile on the PC to the SSD in drive A
on the S3. This is the fastest way to move bulk data from PC to
S3.

-------------
David Palmer
Edinburgh
Scotland
November, 1995